Summary

• replace the slide-only first-run experience with a goal-driven, resumable readiness flow
• detect local agent access without persisting secrets; support organization create/join/select and team visibility setup
• explain Workspace, Project, Work Item, Session, and Organization relationships in context
• add contextual tutorials, setup checklist re-entry, and localized copy for all supported locales
• add native app-menu onboarding re-entry via ⌘⌥O / Ctrl+Alt+O, with DOM fallback and atomic setup-state reset

Validation

• npm run typecheck
• 7 Vitest files / 25 tests
• ESLint over all staged TypeScript/TSX files
• cargo check -p system_services
• cargo clippy -p system_services via pre-commit
• rustfmt --edition 2021 --check src-tauri/crates/system-services/src/app_menu.rs
• real macOS desktop trigger: native menu event received and settings file atomically rewritten

Review notes

• This Draft PR intentionally targets backup/uncommitted-pr-cleanup-20260730 so the review diff contains only the onboarding commit. The local baseline has substantially diverged from develop; rebase and retarget to develop before merge.
• Existing credentials, memberships, workspaces, and product data are not reset by the hidden test entry.
• UI audit: 0 fix / 9 keep-with-reason / 0 abstract.
• Performance guard: pass; passive listeners only, with cleanup and an in-flight gate.